cs.fin.report.suggest.{cashEntryId}
认领匹配建议。
- 请求路由:
cs.fin.report.suggest.{cashEntryId}- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "cs.fin.report.suggest.FE20260620001"
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
cashEntryId | String | 是 | 款项账目 id(路径变量) |
返回
按金额接近度排序的匹配账目流
[
{
"entryId" : "FE20260616001",
"finJobId" : "FJ20260616001",
"party" : {
"role" : "CUSTOMER",
"id" : "CUST10086",
"name" : "深圳市鹏海国际货运"
},
"amount" : 11300.0,
"currency" : "CNY",
"baseAmount" : 11300.0,
"occurAt" : "2026-06-16T08:00:00Z",
"flow" : "AR",
"nature" : "ACCRUAL",
"stage" : "ACTUAL",
"chargeCode" : "OCEAN_FREIGHT",
"settledAmount" : 0,
"remark" : "海运费应收(金额匹配,建议核销)"
}
]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
entryId | String | 账目号(主键) |
finJobId | String | 所属资金档号 |
source | Object | 业务来源引用 |
source.type | String | 来源类型,例如 ATD / AN / BOOKING / ENTRUST / CHANGE / MANUAL |
source.bizId | String | 业务单据 id(工作单号/提单号/委托号等) |
source.eventRef | String | 触发该记账的事件/调用引用,用于幂等与审计 |
party | Object | 往来对象 |
party.role | String | 角色 |
party.id | String | 往来对象 id(客户/供应商/代理/组织 id) |
party.name | String | 名称快照 |
receiptEntity | Object | 实际收款主体快照,仅用于收款,可与数据所属 legalEntityId 不同;提供时 ID、名称均必填。 |
receiptEntity.id | String | 实际收款主体 ID,提供主体信息时必填。 |
receiptEntity.name | String | 登记时的主体名称,后续主体更名不回写历史账目。 |
receiptAccount | Object | 实际收款账号快照,仅用于收款;提供时开户名称、银行名称、账号均必填。 |
receiptAccount.accountName | String | 开户名称,提供账号信息时必填。 |
receiptAccount.bankName | String | 开户银行名称,提供账号信息时必填。 |
receiptAccount.bankCode | String | 银行联行号。 |
receiptAccount.bankAccount | String | 银行账号,提供账号信息时必填。 |
receiptAccount.currency | String | 账号币种快照,不用于替代本笔账目的记账币种。 |
receiptAccount.swiftCode | String | 国际汇款使用的 SWIFT 代码。 |
receiptAccount.address | String | 银行账号地址信息。 |
invoices | Object[] | 收款关联发票快照,可为空或多张;每张须包含号码、类型和税率,不参与账目价税计算。 |
invoices.[].invoiceNo | String | 发票号码,关联发票时必填。 |
invoices.[].invoiceType | String | 调用方提供的发票类型值,关联发票时必填,暂不限制为固定枚举。 |
invoices.[].taxRate | Number | 非负发票税率,关联发票时必填;例如 0.06 表示 6%,允许零税率。 不替代账目自身的 taxRate,也不据此计算收款税额。 |
amount | Number | 原币含税往来金额(价税合计,带符号)。收付款与往来余额均以此为准。 |
currency | String | 币种 |
fxRate | Number | 记账汇率(原币 → 本位币) |
baseAmount | Number | 本位币含税金额(带符号)= amount × fxRate |
direction | String | 借贷方向(预留会计科目映射,不参与余额计算) |
occurAt | String | 业务发生时间 |
priceType | String | 价税类型 |
taxRate | Number | 税率(如 0.06 / 0.09 / 0) |
taxAmount | Number | 原币税额(带符号) |
netAmount | Number | 原币不含税净额(带符号)= amount − taxAmount |
flow | String | 资金流向 AR/AP |
nature | String | 账目性质 |
stage | String | 阶段:预估/实际 |
chargeCode | String | 费用项目编码 |
tags | String[] | 标签(URN 前缀字符串,如 term:PP、src:ATD、region:POL、org:SHA) |
settledAmount | Number | 已核销额(原币,正值) |
reverseOf | String | 红冲指向的被冲账目号 |
remark | String | 备注 |
legalEntityId | String | 法人主体id |
customerId | String | 客户id |
extraProps | Object | 扩展属性 |
crBy | String | 创建者 |
upBy | String | 最后修改者 |
crDate | String | 创建时间 |
upDate | String | 最后修改时间 |
tenantId | String | 租户ID |
id | Varies | 返回账目主键,供统一数据访问与查询映射使用。 |